home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / disk / bkpwiz31.zip / BKPWIZ.EXE / COMMAND.DOC < prev    next >
Text File  |  1996-10-19  |  10KB  |  209 lines

  1.  
  2.  
  3.                           PARK-A-BYTE INC.
  4.                           ---------------
  5.                            BACKUP WIZARD
  6.  
  7.  
  8. The detailed description of EACH command is posted to this file only so that
  9.         the User can get a better handle on the underlying concepts, which 
  10.         will help increase his productivity and help troubleshooting, in the
  11.         event of a problem.
  12.  
  13. It would be a good idea to actually try out at least all four basic (anchor)
  14.         commands at the DOS command line so you get a good feel about the 
  15.         basic concepts involved. It is easy to do so. Anytime, you wish to
  16.         try out any of these commands, while viewing this document,
  17.         (through the README.BAT), just Press Esc key, and choose the menu item,
  18.         GO.BAT and follow the next Menu and Prompts.
  19.  
  20.  
  21. Most of the time use the Go.bat, which gives simple prompts to follow so that
  22.         you dont have to worry about these details about the Parameters 
  23.         explained below.
  24.  
  25. NOTE:    To try out any of the Anchor commands below, at DOS command-line 
  26.          do the following:
  27.         1. type set prog=<name of the command e.g.> BKUP (must be all caps). 
  28.         2. Press Enter
  29.         3. TYPE Mybkp followed by the 2 or 3 parameters explained below, then
  30.         4. Press Enter.
  31.  
  32.  
  33. ========================
  34. ~BASIC (ANCHOR) COMMANDS:~
  35.  
  36.     ~BKUP:~
  37.           First Parameter: - This Parameter specifies the First level Directory 
  38.               Path such as D:\Excel, F:\qpro and so on.
  39.               This is the Directory (and its subdirs) that you want to Back up.
  40.           
  41.           Second Parameter: - This is the Backup Drive (Letter w/colon e.g. D:).
  42.               In all the following three commands this parameter remains the 
  43.               same. This makes it easier to remember the syntax for ALL the 
  44.               commands.
  45.  
  46.           Third Parameter is OPTIONAL - Specifies whether this specific backup 
  47.               should be preserved (p or P), that is, Datestamped. If this one 
  48.               is omitted, the Backup Compressed File will have the normal 
  49.               Extension of 'zip' instead of the Datestamp.
  50.               
  51.           Read details about Datestamping in the File, Features.Doc. (Press Esc
  52.               and choose menu item 'Features').                   
  53.  
  54.     ~BKPDRV:~
  55.           First Parameter: -  This Parameter specifies the ENTIRE SOURCE Drive
  56.              to be backed up. Specify Letter w/colon such as E:. This command 
  57.              is primarily used in ~Preventive Maintenance~ (P.M.). Read details 
  58.              about P.M. in the File, Setinfo.Doc. (Press Esc and choose menu 
  59.              item 'setup info').
  60.          
  61.           Second Parameter is identical to the one for 'Bkup'above.
  62.  
  63.           There is NO Third Parameter called for.
  64.  
  65.     ~BKPEXT:~
  66.           First Parameter: - Identical to that of 'Bkup'. This secifies the
  67.              Directory (automatically includes its subs) from which the files 
  68.              with the extension specified in the Third Parameter, will be 
  69.              extracted and BACKED UP.
  70.  
  71.           Second Parameter is identical to the one for 'Bkup' and 'Bkpdrv'.
  72.  
  73.           Third parameter simply specifies the Extension of files  to be 
  74.             backed up.
  75.  
  76.     ~UNPACK:~
  77.           First Parameter: - Identical to that of 'Bkup'. However, the files
  78.              in this Directory Path will be RETRIEVED instead of being BACKED
  79.              UP! The WIZARD will do all the work of hunting down the 
  80.              appropriate archive (compressed) file and uncompressing it into
  81.              the ORIGINAL PATH!
  82.  
  83.           Second Parameter is identical to the one for 'Bkup' and 'Bkpdrv' above.
  84.  
  85.  
  86.           Third Parameter enables RECOVERY of three different kinds of backups
  87.                 1. Normal conventional backups using 'zip' extension.
  88.                 2. Preserved (Datestamped) backups using a 'datestamp' 
  89.                    extension. Read details about Datestamping in the File, 
  90.                    Features.Doc. (Press Esc and choose menu item 'Features').
  91.                 3. Backups created by 'Bkpext' command with the file extension
  92.                    used as the Backup file extension. However, you must place
  93.                    the character "^" in front of the extension, in answering 
  94.                    the appropriate prompt.
  95.  
  96.         In addition to the above ANCHOR commands, three very useful utilities, 
  97.                MOVEZIP, SYNCHRO and PREPLIST are provided.
  98.  
  99. ===========
  100. ~UTILITIES~
  101.  
  102.     ~MOVEZIP~ 
  103.               - This utility will enable you to MOVE large compressed files in 
  104.                     UNIX-like fashion from one Backup Drive to another, when 
  105.                     you run out of space on one Backup Drive and want to switch 
  106.                     to another WITHOUT having to back up again!!
  107.  
  108.     ~SYNCHRO~
  109.               - Nowadays everybody works on two PCS, one at office and one at
  110.                     Home. Obviously you need to 'synchronize' directories, 
  111.                     bring the files in the corresponding directories on both 
  112.                     the PCs to the same status for a continuing project. 
  113.  
  114.                Now, you can transmit or copy the directories  to temporary 
  115.                     directories on the other PC (use 'xcopy /s') and use 
  116.                     SYNCHRO to synchronize the status of files. You also have 
  117.                     the valuable option of updating (freshening) of ONLY the 
  118.                     existing files in the Target Directory. 
  119.  
  120.               Once you get used to using this feature, you will wonder how you 
  121.                     managed without it!                
  122.  
  123.         
  124.     ~PREPLIST~
  125.  
  126.          You can, if you wish, prepare a simple list of the first-level 
  127.              directories, the data in which gets modified often (or on day to 
  128.              day basis).     
  129.  
  130.          The WIZARD will process the entire list, item by item, while executing 
  131.              any of the commands, Bkup, Bkpext or Unpack. 
  132.  
  133.          Give this list a name, such as ^xlist. Specify this listname in answer 
  134.             to the prompt for Directory to Backup/Retrieve, insteadof the actual
  135.             Directory Ath. Do NOT include the character '^' in the filename.
  136.  
  137. This file will also be used in the feature, AUTOPILOT. (Press Esc and choose 
  138.             menu item, 'SetInfo.txt' to read about this feature in detail).
  139.  
  140.  
  141.  
  142.     EXAMPLE: `Preplist xlist C:\Lotus!D:\Qpro!F:\Excel' 
  143.  
  144.         Please note that there are no spaces in the second parameter, and the 
  145.     list items are separated by a `!' character (none at the end). `xlist', 
  146.     the  first parameter is the name of the list. This is the LISTNAME you can 
  147.     use in `Bkup' (or Unpack or Bkpext) command. For example, Bkup (or Unpack 
  148.     or Bkpext) xlist K:' will backup (or uncompress) (or back up the specific 
  149.     extension, in the case of Bkpext) the files in directories C:\Lotus, 
  150.     D:\Qpro and F:\Excel, one by one, along with all their subdirectories onto (
  151.     or from) the backup drive K:. The third parameter `p(or P) ` (for 
  152.     preservation) will also work with the listname (except for Bkpext for obvious
  153.     reasons).
  154.  
  155.        Please do use 'Preplist.exe' to prepare these lists, because it 
  156.     places the marker 'END' at the end of the list, which you might forget if 
  157.     you prepare the list manually. This marker is absolutely essential for 
  158.     the software to operate properly. Also, the file name must start with a
  159.     character, '^', such as for example '^xlist. This first character is 
  160.     mandatory.  This feature is better explained in the file 'setinfo.txt'
  161.    (Press Esc and choose item 'setinfo.txt').
  162.  
  163. =======
  164. SYNTAX:
  165.  
  166. Notice that the Syntax for all three commands (Bkup, Unpack and Bkpext) is 
  167.     identical. This was done intentionally, so that it will be easier to 
  168.     remember the commands and the parameters.
  169.  
  170.     However, if you find this syntax and parameters confusing or hard to 
  171.     remember, go ahead and just run go.bat at the DOS COMMAND line and follow 
  172.     the prompts.
  173.  
  174.    1. The first parameter is always the path for the first-level directory 
  175.       (or the entire Drive, or a Listname containing several such paths) 
  176.       (Press Esc and choose menuitem 'Features.doc').
  177.  
  178.    2. The second parameter is always the Backup Drive such as `K:' in the 
  179.       example.
  180.  
  181.    3. The third parameter specifies either a `preservation' indicator for 
  182.       Backups, (`p or P') for Bkup command, or the `Date-stamp' (Press Esc and 
  183.       choose menuitem 'Features.doc') such as `4A6' for the `Unpack' command or 
  184.       the file extension such as `^INI' for Bkpext' command. When `unpacking' 
  185.       extension backups be sure to prefix  `^' to the extension such as  
  186.      `^INI' e.g. `Unpack H:\windows  K: ^INI' 
  187.  
  188. Please do not  venture beyond the first level, such as C:\Lotus\Qtr1\spread. If
  189.      you wish to recover single subdirectories two or more levels deep you may 
  190.      use DOS  `Subst' drives and treat them like `entire' drives in the above 
  191.      syntax. Or, temporarily create a new First-level directory, copy the files
  192.      to it and then back it up.
  193.  
  194. We had to drop this feature because of the space it wasted on the Hard Drive 
  195.      (about 7 to 11%). Just stay with the top (first) level directory such as 
  196.      C:\lotus or E:\word etc. All subdirectories including the one you are 
  197.      looking for, WILL be backed up or recovered.  
  198.  
  199. NOTE that if you wish to back up just the ROOT directory by itself without 
  200.      incorporating all the subdirectories of the ENTIRE drive, you must specify 
  201.      C:\Root or E:\root etc. as in Bkup D:\Root G: [P|Ext]
  202.  
  203. This is important since DOS does NOT recognize the root directory as 
  204.      Drive:\root and you will end up backing up ENTIRE drive instead of just
  205.      the root directory itself, if you specify  C:\ E:\ etc., instead of 
  206.      C:\root E:\root.
  207.  
  208.  
  209.